home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / filesy~1 / mfsfm09b.zoo / mfsfm.doc < prev    next >
Encoding:
Text File  |  1993-10-28  |  9.2 KB  |  232 lines
  1. MfsfM (Marcus' file selector for MiNT) Copyright 1993 by Marcus Haebler
  2.  
  3. DISCLAIMER:
  4. -----------
  5.  
  6.   I ACCEPT NO RESPONSIBILITY FOR ANY DAMAGE CAUSED BY THE USE OF THIS
  7. PROGRAM, WHETHER IT IS USED CORRECTLY OR NOT. I GIVE ABSOLUTELY NO WARRANTY
  8. FOR THIS PROGRAM, NOT EVEN AN IMPLIED WARRANTY OF FITNESS FOR A PARTICULAR
  9. PURPOSE. IF YOU DECIDE TO USE THIS PROGRAM, YOU'RE COMPLETELY ON YOUR OWN!
  10.  
  11.  
  12. SHAREWARE
  13. ---------
  14.  
  15. This program is shareware. That means that you have to PAY the shareware 
  16. fee if you use it regulary. The fee is 10 DM.  This should not be too 
  17. much. Send it to the address below and INCLUDE AN ADRESSED AND STAMPED 
  18. ENVELOPE (include 5 DM only if you want the newest version). You can also 
  19. send the money to my bank account(11 DM if you don't have an email 
  20. address, 1 DM postage for the reply). If you are able to receive uuencoded 
  21. emails from the Internet all new version will reach you automatically.
  22. If you are in the Mausnet you can be shure that the newest version will
  23. be available within a few days.
  24. You will get your personal registration code. DON'T FORGET TO INFORM 
  25. ME WHAT'S YOUR EMAIL ADDRESS.
  26. If you did not register MfsfM it will terminate itself after a few calls.
  27.  
  28.  
  29. INTRODUCTION
  30. ------------
  31.  
  32. Today I decided to write this short documentation for my file selector
  33. because it became a little bit complex. I hope that you read this file.
  34. I know reading docs is boring. Please make shure to have MiNT running!!!
  35.  
  36.  
  37. ABOUT MfsfM
  38. -----------
  39.  
  40. MfsfM was and is a file selector for PRAX (something like MultiTOS). _uk_ 
  41. asked me if I could write the file selector for it. First of all I 
  42. hasitated a little bit because I had no experience with something like 
  43. this but in the end I said yes.
  44. It is quite difficult for me to write something like this because I am 
  45. studying chemistry. The study takes a lot of time.
  46. Now why is MfsfM different from all other file selectors (all file 
  47. selectors I know)? MfsfM uses only U:. This means that you get a structure 
  48. like Un*x uses it. U: is the root directory. In root you will find all 
  49. your normal TOS drives mounted. This is done by MiNT. MfsfM supports long 
  50. file names and case sensitiv file systems like the Minix file system or 
  51. Ydisk. MfsfM follows the "TOS goes Un*x" trend. I hope that Atari will 
  52. follow this trend, too.
  53.  
  54.  
  55. INSTALLATION
  56. ------------
  57.  
  58. Look into the file INSTALL. You will find all informations there.
  59.  
  60.  
  61. PATH AND FILE NAME
  62. ------------------
  63.  
  64. You will find that the path and file name are scrollable. The file name is 
  65. not scrollable on a TOS file system because there is no need for this. If 
  66. you click on the path or the file name and it was not editable it becomes 
  67. editable. If you have clicked on the path and the file name is a valid 
  68. file this file will be automatically selected. Play around with it. There 
  69. is a function I should mention: If you double click the path the directory 
  70.  is read. You can also use this function to reread a directory.
  71.  
  72.  
  73. THE FILE WINDOW
  74. ---------------
  75.  
  76. Everything should be easy to use. Just a few words concerning the bar at 
  77. the top. If you double click it you will be able to change the regular 
  78. expression.
  79. "?" and "*" are working like in the TOS file selector. "*.*" is equal to 
  80. "*". See OPTIONS.
  81. With the double arrows you can get further information about the files. 
  82. Since 1.04 there are icons instead of type characters. You have to use a 
  83. System font >= 16 * 8 to get them.
  84. Also since 1.04 there is a popup on the "\"-button. If you select a drive 
  85. letter in the popup it has the same effect as clicking on a drive letter 
  86. in the original file selector.
  87. NOTE: If the caller runs in the TOS domain. You can only see regular files 
  88. and directories. If the caller is in the MiNT domain the file selector 
  89. uses Fxattr(). The effect is that you can see links, processes, character 
  90. devices and pipes, too.
  91.  
  92.  
  93. OPTIONS
  94. -------
  95.  
  96. Here you can set up the behavior of the file selector:
  97.   o Follow links: Fxattr will follow links if this is turned on.
  98.   o Hide TOS hidden files: TOS file with hidden attribute are not shown.
  99.   o Hide Un*x hidden files: files with a leading "." are not shown.
  100.   o Online slider: the slider becomes an online slider.
  101.   o Save last path: The file selector ignores the path that is passed to it
  102.     it uses the last shown path.
  103.   o "*.*" is equal to "*": What do you exspect?
  104.  
  105. Since version 1.05 you can save the options. The file mfsfm.cnf can be put 
  106. in the root dir of every drive. It will be searched automatically for 
  107. this. The search is done in the following order: C, D, ..., Z, A, B This 
  108. means that the disk drives are the last drives. If you set the environment 
  109. variable MFSFMCNF to e.g. d:\dir\subdir\mfsfm\mfsfm.cnf you can put the 
  110. config file everywhere.
  111.  
  112.  
  113. THE SORT POPUP
  114. --------------
  115.  
  116. You can choose the method of sorting here. The options "reverse", 
  117. "numbers", "dir2top" and the actual method are saved in mfsfm.cnf. There 
  118. are the following entries int the popup:
  119. by name: sort by name
  120. by type: sort by file type (directory, regular file, symbolic link etc.)
  121. by ext.: sort by extension. The extension is the string that follows the
  122.          last "." in the file name. "Z" is the extension of "test.tar.Z"
  123. by size: sort by the length of th files.
  124. by date: sort by the time stamp of the files.
  125. no sort: no sorting, options like "reverse", "dir2top" are ignored.
  126. There are also the following options:
  127. reverse: sort in reverse order.
  128. numbers: look at numbers. This means that "test2" stands before "test10".
  129. dir2top: directories are sorted to the top.
  130.  
  131.  
  132. THE "FILE..." POPUP
  133. -------------------
  134.  
  135. This popup supports various file operations. If you want e.g. to move a 
  136. file do the following things. Klick file. Klick "mark" in the popup. 
  137. Change to the target path. Klick "move" in the popup. If you only want to 
  138. rename a file mark it. Type the new name in the selection field and klick 
  139. on "move".
  140. It is important to know that the operations in the popup refer to the file 
  141. name in the selection field. You can also type a name of a directory in 
  142. the and delete it. Moving and copying is impossible with directories.
  143.  
  144.  
  145. THE INFO BUTTON AND REGISTRATION
  146. --------------------------------
  147.  
  148. If you click on it you will get an information dialog. You can see the 
  149. usual things there. To registrate MfsfM you must click on the register 
  150. button the register dialog is easy to use. You should save the options 
  151. after registration otherwise you have to register after every booting.
  152. Therefore it is NOT allowed to COPY your MFSFM.CNF file after 
  153. registratiom.
  154.  
  155.  
  156. SIGNALS
  157. _______
  158.  
  159. You can send signals to MfsfM. It catches the following signals:
  160. Signals to kill MfsfM cleanly: SIGHUP, SIGINT, SIGQUIT, SIGTERM
  161. NOTE: MfsfM is not killed at once. If it recognizes that the file selector
  162.       is not called at the moment, it terminates. If the file selector is
  163.       active, then it waits for the file selector.
  164. There is also the possibility to disable MfsfM for a short time. Send a
  165. SIGTSTP (Nummer 18) to MfsfM. Send a SIGCONT (Nummer 19) to enable it.
  166. NOTE: If MfsfM is disabled this does _not_ mean that it is no longer in
  167.       the xbra chain. There is a flag set after a SIGTSTP. The effect is
  168.       that the caller falls through.
  169.  
  170.  
  171. THE DOMAIN BOX
  172. --------------
  173.  
  174. The domain of the caller is displayed in this box. You can change the 
  175. domain by clicking in this box. If you click in the box a dialog appears 
  176. and asks you if you are really shure. You SHOULD NOT USE this feature if 
  177. you are not absolutly shure what you are doing. It can have lots of bad 
  178. effects. Only a few programs can handle the resulting effects. There is no 
  179. need to change from the MiNT domain back to the TOS domain. Who would use 
  180. a Space Shuttle if there is the Heart of Gold available. :-). Changing 
  181. from the TOS to the MiNT domain is very dangerous. Not everyone/ program 
  182. can navigate the Heart of Gold.
  183.  
  184.  
  185. THE END
  186. -------
  187.  
  188. This was all. I hope that this documentation is short enough to be read by
  189. everyone. If you have further questions drop me a note.
  190.  
  191.  
  192. THANKS GO TO
  193. ------------
  194.  
  195.  - my girl friend Nicole for her patience and comprehension.
  196.  - _uk_ (Ulrich Kühn) for inspiration, ideas, critics and help.
  197.  - Eric for MiNT and answering my questions so quickly.
  198.  - rosebud (Uwe Seimet) for trying to answer my stupid questions and testing.
  199.  - Spell (Michael Hohmut) for the idea of making PRAX, ideas and bug reports.
  200.  - tfs and _Zork_ for ydisk.
  201.  - Julian for the idea with the small images.
  202.  - the authors of xv3.00 for their nice images.
  203.  - tfs for the symbolic link image.
  204.  - spoil (Laurenz Prüßner) for ideas and critics.
  205.  - Gryf (Thomas Binder) for bugreports, critics, ideas and icd2ahdi.
  206.  - Dirch (Dirk Klemmt) for bugreports, critics, phone calls and pushing me 
  207.    to work
  208.  - Chris(Christian Felsch) for ideas, critics and bugreports.
  209.  - and all the others on #Atari for answering my questions.
  210.  
  211.  
  212. GREETINGS TO
  213. -------------
  214.  
  215. _uk_, Spell, tfs, rosebud, Uzul, cortex, _Zork_, connect, Hackbear,
  216. Wizzcat, Knightman, ki (I am waiting for the new Sysmon), ah, eye, gsch,
  217. daryl_, Marsu, Gard, Gero(shift4??), spoil, dirch, Gryf ... and all the 
  218. others on #Atari.
  219.  
  220. --- 
  221.  
  222. Address:            Email:                        Voice:
  223.    Marcus Haebler
  224.    Althausweg 29    haebler@uni-muenster.de       02 51 / 21 33 93
  225.    48159 Muenster
  226.    Germany
  227.  
  228. IRC: D_Gently
  229.  
  230. Bankverbindung:
  231. Stadtsparkasse Muenster, BLZ 400 501 50, Kontonummer: 109 070 946
  232.